---
title: 初始化PXF
---

<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements.  See the NOTICE file
distributed with this work for additional information
regarding copyright ownership.  The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License.  You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied.  See the License for the
specific language governing permissions and limitations
under the License.
-->

你必须显式初始化PXF服务实例。 此一次性初始化将创建PXF服务Web应用程序并生成PXF配置文件和模板。


PXF提供了两个你可以在初始化时候使用的管理命令

- [`pxf cluster init`](ref/pxf-cluster.html) - 初始化所有在GP集群中的pxf服务实例
- [`pxf init`](ref/pxf.html) - 初始化当前节点上的pxf服务实例

## <a id="init_pxf"></a> PXF配置属性

PXF同时支持内部的和用户自定义的配置属性。初始化PXF会生成PXF内部配置文件，并设置特定于您的配置的默认属性。初始化PXF还会为用户自定义设置生成配置文件模板，例如自定义配置文件和PXF运行时间和日志记录设置。

PXF内部配置文件位于`$GPHOME/pxf/conf`目录，在初始化PXF时，你可以通过指定环境变量`$PXF_CONF`来配置用户目录。如果在初始化PXF之前未设置`$PXF_CONF`，PXF可能会在初始化过程中提示您接受或拒绝默认用户配置目录`$HOME/pxf`。

**Note**: 选择可以备份的`$PXF_CONF`位置，并确保他在GPDB安装目录之外。

在初始化期间，PXF会根据需要创建`$PXF_CONF`目录然后使用子目录和模板文件填充他。有关这些目录和内容的列表，可以参照[PXF User Configuration Directories](about_pxf_dir.html#usercfg)


### <a id="init-pxf-prereq" class="no-quick-link"></a>准备

GPDB实例初始化PXF之前，请确保:

- GPDB集群是启动并且运行的
- 可以通过`$PXF_CONF`指定PXF用户配置目录的文件位置，并且`gpadmin`用户也需要对这个目录有写权限

### <a id="init-pxf-steps" class="no-quick-link"></a>过程

执行一下流程确保在你的GPDB集群的每个节点初始化PXF。

1. 登录GPDB的master节点

    ``` shell
    $ ssh gpadmin@<gpmaster>
    ```

4. 运行`pxf cluster init`命令会在master节点和所有的segment节点主机上初始化PXF服务。如下命令指定`/usr/local/greenplum-pxf`作为pxf初始化的用户配置目录

    ``` shell
    gpadmin@gpmaster$ PXF_CONF=/usr/local/greenplum-pxf $GPHOME/pxf/bin/pxf cluster init
    ```

    `init`命令创建了pxf网页应用和pxf内部配置。init命令也创建了`$PXF_CONF`用户配置目录（如果目录不存在）并使用用户可自定义的配置模板填充目录。

    **Note**:PXF服务只运行在segment主机上，然而`pxf cluster init`命令也会安装在GPDB的master主机上创建PXF用户配置目录。
